home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1995 November
/
EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso
/
earcd
/
program
/
gcc
/
ixemul-4.lha
/
ixemul-41.4
/
man
/
cat3
/
fgetline.0
< prev
next >
Wrap
Text File
|
1992-08-10
|
2KB
|
67 lines
FGETLINE(3) UNIX Programmer's Manual FGETLINE(3)
NNAAMMEE
ffggeettlliinnee - get a line from a stream
SSYYNNOOPPSSIISS
##iinncclluuddee <<ssttddiioo..hh>>
_c_h_a_r _*
ffggeettlliinnee(_F_I_L_E _*_s_t_r_e_a_m, _s_i_z_e___t _*_l_e_n)
DDEESSCCRRIIPPTTIIOONN
The ffggeettlliinnee() function returns a pointer to the next line from the
stream referenced by _s_t_r_e_a_m. The newline character at the end of the line
is replaced by a NUL.
If _l_e_n is nonNULL, the length of the line, not counting the terminating
NUL, is stored in the memory location it references.
RREETTUURRNN VVAALLUUEESS
Upon successful completion a pointer is returned; this pointer becomes
invalid after the next I/O operation on _s_t_r_e_a_m (whether successful or
not) or as soon as the stream is closed. Otherwise, NULL is returned.
The ffggeettlliinnee() function does not distinguish between endoffile and er
ror; the routines feof(3) and ferror(3) must be used to determine which
occurred. If an error occurrs, the global variable _e_r_r_n_o is set to indi
cate the error. The endoffile condition is remembered, even on a ter
minal, and all subsequent attempts to read will return NULL until the
condition is cleared with clearerr(3).
The text to which the returned pointer points may be modified, provided
that no changes are made beyond the terminating NUL. These changes are
lost as soon as the pointer becomes invalid.
EERRRROORRSS
[EBADF] The argument _s_t_r_e_a_m is not a stream open for reading.
The ffggeettlliinnee() function may also fail and set _e_r_r_n_o for any of the errors
specified for the routines fflush(3), malloc(3), read(2), stat(2), or
realloc(3).
SSEEEE AALLSSOO
ferror(3), fgets(3), fopen(3), putc(3)
HHIISSTTOORRYY
The ffggeettlliinnee() function is currently under development.
BBUUGGSS
It is not possible to tell whether the final line of an input file was
terminated with a newline.
BSD Experimental April 19, 1991 1